Getting and Setting Progress Procs 17

GraphicsExportSetProgressProc

Installs a progress procedure.



 
pascal ComponentResult GraphicsExportSetProgressProc (GraphicsExportComponent ci,

                                         ICMProgressProcRecordPtr progressProc);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
progressProc: Points to a progress function structure. If you pass a value of -1, you obtain a standard progress function. If you want to remove the existing progress function, pass nil .

DISCUSSION

See Chapter 1, "Movie Toolbox," in the QuickTime 4 Reference for more information about progress functions.

If your progress function does any drawing, you should take care to set a safe graphics state before doing so, and to restore the graphics state afterwards. In particular, the current graphics device may be an offscreen device.

RESULT CODES

`noErr`	0	No error
`paramErr`	-50	Invalid parameter specified
`memFullErr`	-108	Not enough memory available

GraphicsExportGetProgressProc

Returns the current progress procedure.



 
pascal ComponentResult GraphicsExportGetProgressProc (GraphicsExportComponent ci,

                                         ICMProgressProcRecordPtr progressProc);

ci: Specifies the component instance that identifies your connection to the graphics exporter component.
progressProc: A pointer to a progress procedure structure.

DISCUSSION

By default, graphics export components have no progress procedure.

RESULT CODES

`noErr`	0	No error
`paramErr`	-50	Invalid parameter specified
`memFullErr`	-108	Not enough memory available